package org.ymf.service;

import com.github.pagehelper.PageInfo;
import org.springframework.web.multipart.MultipartFile;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.List;
import org.ymf.entity.Post;
import com.baomidou.mybatisplus.extension.service.IService;
import org.ymf.vo.PostVo;

/**
 * <p>
 * 帖子 服务类
 * </p>
 *
 * @author Malphite
 * @since 2023-08-01
 */
public interface PostService extends IService<Post> {

    /**
     * 分页查询帖子
     * @param vo        可选条件 、 开始时间(startTime)、结束时间(endTime)、
     * @return          帖子分页信息
     */
    PageInfo<Post> pagePost(PostVo vo);

    /**
     * 列表查询帖子
     * @param vo        可选条件 、 开始时间(startTime)、结束时间(endTime)、
     * @return          帖子列表信息
     */
    List<Post> listPost(PostVo vo);

    /**
     * excel导入帖子
     * @param file       文件源
     * @param objects    空的 Post 泛型的 arrayList
     * @param request    请求对象
     * @return           已经插入的list集合
     */
    List<Post> excelPost(MultipartFile file, List<Post> objects, HttpServletRequest request);

    /**
     * 添加帖子基础信息
     * @param post       帖子信息
     * @param request   请求对象
     * @return          成功or失败
     */
    boolean addPost(Post post, HttpServletRequest request);

    /**
     * 更新帖子基础信息
     * @param post       帖子信息, 主键信息必填
     * @return          成功or失败
     */
    boolean updatePost(Post post);

    /**
     * 删除帖子基础信息
     * @param post       帖子信息, 主键信息必填
     * @return          成功or失败
     */
    boolean deletePost(Post post);

    /**
     * 帖子excel导出
     * @param vo  页面传入参数(startTime:开始时间;endTime:结束时间 )
     * @param response 响应对象
     * @return   无返回值，通过响应对象响应信息
     * @throws IOException  调用方法可能发生io异常等
     */
    void exportPost(PostVo vo, HttpServletResponse response) throws IOException;

    /**
     * 分页查询帖子 => 根据 lasticsearch 查询信息
     * @param vo        可选条件 、 开始时间(startTime)、结束时间(endTime)、
     * @return          帖子分页信息
     */
    PageInfo<Post> pagePostEs(PostVo vo);

}
